v2.2.0

Compare Source

Added

• Add React 19 support (#​3543)

v2.1.10

Compare Source

Fixed

• Use React.JSX instead of deprecated global JSX (#​3511)
• Fix crash in ListboxOptions when using as={Fragment} (#​3513)

v2.1.9

Compare Source

Fixed

• Ensure Element is available before polyfilling to prevent crashes in non-browser environments (#​3493)
• Fix crash when using instanceof HTMLElement in some environments (#​3494)
• Cleanup process in Combobox component when using virtualization (#​3495)

v2.1.8

Compare Source

Fixed

• Fix crash when using as={Fragment} on MenuButton, ListboxButton, DisclosureButton or Button components (#​3478)

v2.1.7

Compare Source

Fixed

• Prevent crash in environments where Element.prototype.getAnimations is not available (#​3473)

v2.1.6

Compare Source

Fixed

• Fix ListboxOptions being incorrectly marked as inert (#​3466)
• Fix crash when using DisclosureButton inside of a DisclosurePanel when the Disclosure is open by default (#​3465)

v2.1.5

Compare Source

Fixed

• Fix transition bug on Firefox, triggered by clicking the PopoverButton in rapid succession (#​3452)

v2.1.4

Compare Source

Fixed

• Fix components not closing properly when using the transition prop (#​3448)

v2.1.3

Compare Source

Fixed

• Ensure Transition component state doesn't change when it becomes hidden (#​3372)
• Fix closing components using the transition prop, and after scrolling the page (#​3407)
• Ensure all client components are marked correctly to avoid a crash with React 19 and Turbopack (#​3429)

v2.1.2

Compare Source

Fixed

• Fix prematurely added anchoring styles on ListboxOptions (#​3337)
• Ensure unmount on Dialog works in combination with the transition prop on DialogBackdrop and DialogPanel components (#​3352)
• Fix crash in Combobox component when in virtual mode when options are empty (#​3356)
• Fix hanging tests when using anchor prop (#​3357)
• Fix transition and focus prop combination for PopoverPanel component (#​3361)
• Fix outside click in nested portalled Popover components (#​3362)
• Fix restoring focus to correct element when closing Dialog component (#​3365)
• Fix flushSync warning for Combobox component with immediate prop enabled (#​3366)

v2.1.1

Compare Source

Fixed

• Fix issues spreading omitted props onto components (#​3313)
• Fix initial anchor="selection" positioning (#​3324)
• Fix render prop in ComboboxOptions to use any instead of unknown (#​3327)
• Fix incorrect Transition boundary for Dialog component (#​3331)

v2.1.0

Compare Source

Added

• Add ability to render multiple Dialog components at once (without nesting them) (#​3242)
• Add new data-attribute-based transition API (#​3273, #​3285, #​3307, #​3309, #​3312)
• Add DialogBackdrop component (#​3307, #​3310)
• Add PopoverBackdrop component to replace PopoverOverlay (#​3308)

Fixed

• Keep Combobox open when clicking scrollbar in ComboboxOptions (#​3249)
• Ensure ComboboxInput does not sync with current value while typing (#​3259)
• Fix visual jitter in Combobox component when using native scrollbar (#​3190)
• Improve UX by freezing ComboboxOptions while closing (#​3304)
• Merge incoming style prop on ComboboxOptions, ListboxOptions, MenuItems, and PopoverPanel components (#​3250)
• Prevent focus on Checkbox when it is disabled (#​3251)
• Use useId instead of React internals (for React 19 compatibility) (#​3254)
• Cancel outside click behavior on touch devices when scrolling (#​3266)
• Correctly apply conditional classes when using Transition and TransitionChild components (#​3303)

Changed

• Allow using the Tab and Shift+Tab keys when the Listbox component is open (#​3284)

v2.0.4

Compare Source

Fixed

• [internal] Don’t set a focus fallback for Dialog’s in demo mode (#​3194)
• Ensure page doesn't scroll down when pressing Escape to close the Dialog component (#​3218)
• Fix crash when toggling between virtual and non-virtual mode in Combobox component (#​3236)
• Ensure tabbing to a portalled <PopoverPanel> component moves focus inside (without using <PortalGroup>) (#​3239)
• Only handle form reset when defaultValue is used (#​3240)

Deprecated

• Mark SwitchGroup as deprecated, prefer Field instead (#​3232)

Changed

• Use native fieldset instead of div by default for <Fieldset /> component (#​3237)

v2.0.3

Compare Source

Fixed

• Make sure disabling demo mode on <Combobox> works (#​3182)

v2.0.2

Compare Source

Fixed

• Improve performance of internal useInertOthers hook (#​3181)

v2.0.1

Compare Source

Fixed

• Remove accidental deprecation comments on <DialogPanel> and <DialogTitle> (#​3176)

v2.0.0

Compare Source

Added

• Add new Checkbox component (#​2887, #​2962)
• Add new Button component (#​2887)
• Add new Input component (#​2887, #​2902, #​2940)
• Add new Textarea component (#​2887, #​2902, #​2940)
• Add new Select component (#​2887, #​2902)
• Add new Fieldset and Legend components (#​2887)
• Add new Field, Label, and Description components (#​2887, #​2941)
• Add new MenuSection, MenuHeading, and MenuSeparator components (#​2887)
• Add new ListboxSelectedOption component (#​2887)
• Add new DataInteractive component (#​2887)
• Add new CloseButton component and useClose hook (#​3096)
• Add new anchor, modal, and portal props to Combobox, Listbox, Menu and Popover components (#​2887, #​3075, #​3097, #​3111, #​3115, #​3121, #​3124, #​3133, #​3138, #​3148, #​3152, #​3154, #​3157)
• Add new autoFocus prop to focusable components (#​2887)
• Add new virtual prop to Combobox component (#​2779, #​3128, #​3160, #​3161, #​3163)
• Add new onClose prop to Combobox component (#​3122)
• Add new immediate prop to Combobox for immediately opening the Combobox when the input receives focus (#​2686)
• Add new --button-width CSS variable on the ListboxOptions, MenuItems, and PopoverPanel components (#​2887, #​3058)
• Add new --input-width and --button-width CSS variables on the ComboboxOptions component (#​3057)
• Add new data-* attributes as an alternative to the existing data-headlessui-state attribute (#​2887, #​3035, #​3061)

Fixed

• Fix scroll-locking on iOS (#​2891)
• Fix cancellation of events when using disabled or aria-disabled attributes (#​2890)
• Fix unnecessary execution of the displayValue callback in ComboboxInput component (#​3048)
• Fix types for multiple prop in Combobox component (#​3099)
• Fix focus handling in ComboboxInput component (#​3065, #​3073)
• Fix enter transitions in Transition component (#​3074)
• Fix focus handling in ListboxOptions and MenuItems components (#​3112)
• Fix horizontal scrolling inside the Dialog component (#​2889)
• Don’t cancel touchmove on input elements inside a dialog (#​3166)

Changed

• Require React 18 (#​2887, #​3092, #​3131)
• Always render hidden form input fields for Checkbox, Switch, and RadioGroup components (#​3095)
• Deprecate the RadioGroup.Option component in favor of new Radio component (#​2887)
• Dialog is now focused by default instead of the first focusable element (#​2887)
• Change default tags for ListboxOptions, ListboxOption, ComboboxOptions, ComboboxOption, and TabGroup components (#​3109)
• Change default tag from div to Fragment on Transition components (#​3110, #​3147)
• Allow Combobox component to have a null value (#​3064, #​3100)
• Attempt form submission when pressing enter on the ListboxButton component (#​2972)
• Deprecate the entered prop on the Transition component (#​3089)
• Deprecate dot notation for components (#​2887, #​3170)
• Add frozen value to ComboboxOptions component (#​3126)
• Remove deprecated DialogBackdrop and DialogOverlay components (#​3171)